home *** CD-ROM | disk | FTP | other *** search
/ Erotic Encounters / Erotic Encounters.iso / vpic49 / vpic.doc < prev    next >
Text File  |  1992-06-01  |  69KB  |  1,292 lines

  1.                              VPIC USERS MANUAL
  2.                    A Picture File Viewing/Conversion Program
  3.          (C) Copyright 1990-1992 Bob Montgomery, All Rights Reserved
  4.                             by Bob Montgomery
  5.                               CIS 73357,3140
  6.  
  7.     INTRODUCTION
  8.  
  9.     The original program was called VGIF, reflecting its ability  to  view  only
  10.     GIF files. When the program evolved to include other paint file formats, its
  11.     name was changed to VPIC. VPIC ver 4.0 and up implements  all  of the GIF89a
  12.     features. See the revision history in Appendix  A  for  latest additions and
  13.     bug fixes.
  14.  
  15.     Print VPIC.TXT at 17 chars/inch and 8 lines/inch for a handy reference card.
  16.     Look at the section titled 'How Vpic Operates'  for  an  explanation of  the
  17.     differences between VPIC and other viewers,  and  the  advantages  and  dis-
  18.     advantages of both types.
  19.  
  20.     GENERAL FEATURES - VPIC is a very easy to use but powerful file  viewer  and
  21.     converter. It shows pictures in EGA, MCGA, VGA or SuperVGA  video  modes  on
  22.     most of the popular display adapter cards,  and uses a  plain  text  config-
  23.     uration file to tell VPIC which VGA chip your display  card  uses  and  what
  24.     video modes it can do. It has a single file, slideshow, and menu mode of op-
  25.     eration, and will show pictures in many of the popular file formats. When  a
  26.     picture is on the screen, except in slide modes, VPIC has commands to manip-
  27.     ulate the picture, or convert the picture to other file formats. All this in
  28.     a fast, easy to use program that puts you in total control, and is rated  by
  29.     users as the top in it's class.
  30.  
  31.     MENU MODE - This is the default mode when you just enter VPIC from  the  DOS
  32.     command line. It lists all viewable files in a 4 column menu  with  easy  to
  33.     use controls to allow you to show pictures the way you  want  to  see  them,
  34.     including a slide mode. See Menu Features.
  35.  
  36.     SINGLE FILE MODE - This mode has advanced features which make it  attractive
  37.     for application programs which don't have  the  ability  to  display  hi-res
  38.     graphics, such as data bases. You can shell to VPIC with a filename and  the
  39.     /r option to display a picture and return immediately to  your  application,
  40.     without waiting for user input or displaying the shareware message.  If  you
  41.     want user input, call a batch file containing 'vpic /r %1' and 'wait 100'.
  42.  
  43.     SLIDE MODE - This mode uses a plain text command file listing  the  pictures
  44.     you want to see in the order you want to see them, with mode and delay specs
  45.     if desired. This is particularly useful to showcase  your  product  line  at
  46.     trade shows, or to put on a self running demo. See Slideshows.
  47.  
  48.     IMPORTANT: VPIC requires DOS 2.0 or up to run from the current directory, or
  49.     DOS 3.0 up to run from anywhere.  You must configure VPIC for your  graphics
  50.     board using CVPIC or CONFIG (unless you have a Tseng ET-4000 SuperVGA  board
  51.     with 1M memory). The WHICHVGA program will try to  identify  your  VGA  chip
  52.     and the amount of display memory. See CONFIG.DOC.
  53.  
  54.     The Graphics Interchange Format (GIF) is a Service Mark owned by Compuserve.
  55.     For further information, please contact:
  56.         Compuserve Incorporated, Graphics Technology Department,
  57.         5000 Arlington Center Boulevard, Columbus, Ohio 43220, USA
  58.  
  59.  
  60.  
  61.  
  62.                                   INDEX
  63.  
  64.     Topic                                                                Page
  65.     ============================================================================
  66.     SuperVGA Boards Supported ............................................. 1
  67.     Filetypes Viewed and Converted ........................................ 1
  68.     Menu Features ......................................................... 2
  69.         Mouse Support ..................................................... 2
  70.         Menu Layout ....................................................... 2
  71.     Commands while Viewing ................................................ 3
  72.     VPIC Command Line Options ............................................. 4
  73.     Examples of VPIC Command Line Options ................................. 5
  74.     Slideshows ............................................................ 6
  75.     Detailed Command List ................................................. 7
  76.         Keyboard and Mouse Commands in Menu Mode .......................... 7
  77.         Keyboard Commands while Viewing a Picture ......................... 8
  78.     Decoding Other File Formats .......................................... 11
  79.     Added features ....................................................... 11
  80.     Known Problems ....................................................... 11
  81.     Support For Other SuperVGA Boards .................................... 12
  82.     How VPIC Operates .................................................... 13
  83.         Decoding Directly to Screen Memory ............................... 13
  84.         Decoding to CPU Memory First ..................................... 13
  85.     VPIC Terms and Conditions ............................................ 14
  86.     Upgrades from Previous Programs and Updates .......................... 15
  87.     Orders from Me ....................................................... 15
  88.     Disclaimer ........................................................... 15
  89.     Special Versions ..................................................... 16
  90.     Graphic Oriented BBS's ............................................... 16
  91.     Appendix A - Revision History ........................................ A1
  92.         History of VGIF .................................................. A1
  93.         History of VPIC .................................................. A3
  94.  
  95.  
  96.                                                                          Page 1
  97.  
  98.  
  99.     SUPERVGA BOARDS SUPPORTED  -  Presently, VPIC has SuperVGA support  for  the
  100.     following SuperVGA chips (see CONFIG.DOC for details):
  101.     *  Ahead (A & B chip)
  102.     *  ATI New and old boards.
  103.     *  Chips & Technology
  104.     *  Everex
  105.     *  Genoa
  106.     *  Headland - Newer Video 7 cards.
  107.     *  Oak
  108.     *  Paradise - Older Paradise cards.
  109.     *  S3 GUI Accelerator - Doesn't use VESA info since not all modes supported.
  110.     *  Trident (8800BS/CS and 8900)
  111.     *  Tseng(ET-3000 and ET-4000)
  112.     *  Video 7 - Older Video 7 cards.
  113.     *  Western Digital - Recent Paradise cards.
  114.     *  Zymos
  115.     The CONFIG program semi-automates the configuration process. If your display
  116.     board implements the VESA standard (thru BIOS or a TSR), this will be  auto-
  117.     detected and used regardless of the configuration; the only drawback to VESA
  118.     is you can't scroll down quite as far. The /v command line option makes VPIC
  119.     ignore the VESA info your display card returns, and  use  the  configuration
  120.     info.
  121.  
  122.  
  123.     FILETYPES VIEWED AND CONVERTED - VPIC will view and convert to the following
  124.     file formats [convert command while viewing in brackets]:
  125.      1. Dr. Halo CUT files (with PAL if present). Not Dr. Halo PIC files,  which
  126.         are display adapter specific. [C]
  127.      2. GIF87a and GIF89a files; saves to GIF87a format only since GIF89a  stuff
  128.         is  mainly  animation  and  text  handling  enhancements.    [G normal],
  129.         [I interlaced], [M mirrored],  [U upside down],  [< rotated CCW 90 deg],
  130.         [> rotated CW 90 deg].
  131.      3. Deluxe Paint LBM (or IFF) files, regular and enhanced. [D]
  132.      4. MacIntosh MAC files. Display only.
  133.      5. Pictor/PC Paint PIC files. [P]
  134.      6. ZSoft PCX files (including 256 color files). [Z]
  135.      7. ColorRIX/EGA Paint SCx files, uncompressed only.  RIX  wont tell  anyone
  136.         his compression algorithm,  so  compressed  files  can't  be  done.  Use
  137.         RIXLATE to uncompress SCx files that are compressed. [R]
  138.      8. Targa 8 thru 32 TGA files, compressed or uncompressed. Also uncompresses
  139.         Targa files that are compressed (e option while viewing).  Now  supports
  140.         the Sierra DAC in 15 bit color, but file conversion options  don't  work
  141.         from viewing screen. [T]
  142.      9. Binary Image Files (BIF) from B&W image capture boards. Display only.
  143.     10. Microsoft Windows 3.0 Bitmap BMP files, compressed or normal. [W]
  144.     11. Viewpoint PIC files with a fixed palette (usually 1024x768x256). Display
  145.         only.
  146.  
  147.                                                                          Page 2
  148.  
  149.  
  150.     MENU FEATURES:
  151.  
  152.     *  Handles up to 500 files using mouse or keyboard.
  153.     *  Gives 4 column menu of files with extensions VPIC recognizes.
  154.     *  Arrow keys, PgUp/PgDn move thru menu.
  155.     *  Starting letter (or number) of filename jumps to files starting with that
  156.        character.
  157.     *  Shows file at cursor with ENTER or left mouse button.
  158.     *  Mark/unmark files for viewing with SPACEBAR or right mouse button.
  159.     *  Shows marked files singly (ENTER or left mouse button) or  like  a  slide
  160.        show (F2).
  161.     *  [F1] gives help.
  162.     *  [F2] shows marked files like a slideshow.
  163.     *  [F3] gives file size and colors.
  164.     *  [F4] toggles between 16 (EGA) and 256 (VGA) color modes.
  165.     *  [F5/F6] decrease/increase default resolution.
  166.     *  [F7] Locks current resolution, or selects auto resolution mode.
  167.     *  [F8] Makes multiple GIF images pause for a keypress.
  168.     *  [F9] prompts for new path.
  169.     *  [F10] shows current path for files.
  170.     *  Alt_D prompts for new slide delay for slideshow (F2).
  171.     *  Alt_X prompts if you want to delete the file at the cursor.
  172.     *  Menu text color setable in configuration file.
  173.  
  174.     MOUSE SUPPORT All the above functions are now  controllable  by  the  mouse.
  175.     Click on the resolution bar, bottom 2 lines of quick help, or files. For the
  176.     menu screen, the left button is the same as enter, and the right  button  is
  177.     the same as the spacebar. While decoding, the  right  button  aborts;  while
  178.     viewing, the left button returns to the menu.
  179.  
  180.     MENU LAYOUT  - Menu lines are as follows:
  181.     1. Gives the board type along with the number of colors (16 or 256).  Toggle
  182.        values also appear on this line (Lock/Auto, Wait).
  183.     2. Gives the resolutions available with the default resolution highlighted.
  184.     3 - 22. Four column menu of files with extensions VPIC recognizes.
  185.     23. Prompt and message line. Free memory displayed at far right.
  186.     24 & 25. Quick help on commands.
  187.  
  188.                                                                          Page 3
  189.  
  190.  
  191.     COMMANDS WHILE VIEWING  -  The following commands  (shown  in  brackets) are
  192.     available when the picture is on the screen (/ or ? gives a help menu):
  193.     *  Shows filename while decoding, and [ESC] aborts decoding.
  194.     *  [A] animates a  picture  by  rotating  the  palette;  very  pleasing  for
  195.        fractals. SPACEBAR pauses the  animation,  ENTER  stops  it  for  further
  196.        commands such as conversions, and ESC returns to the menu.  Up/Dn  arrows
  197.        and PgUp/PgDn increase/decrease the animation rate.
  198.     *  [B] converts a 256 color picture to 64 gray shades. 256 color modes only.
  199.     *  [E] expands a compressed Targa to disk for use by other programs.
  200.     *  [F] prompts for another  filename  and  x,y  margins;  gives  picture  in
  201.        picture. Works best when VPIC invoked with /m, /x,  and  /y options  (see
  202.        command line options).
  203.     *  [C, D, G, I, M, P, R, T, U, W, Z, <, >] are file conversion commands; see
  204.        'FILETYPES VIEWED' above.  The picture is  converted  in  the  number  of
  205.        colors you are viewing it in, thus allowing 256 <-> 16 color conversions.
  206.     *  [Alt F] momentarily display filename in case you forgot.
  207.     *  [Alt X] prompts if you want to delete this file; Y deletes.
  208.     *  [F1-F10] are adjustments for red, green,  blue,  contrast, and brightness
  209.        which decrease/increase in pairs; ie F1 decreases red, f2 increases  red.
  210.        [Alt F10] restores the original palette (except after a [B] command).
  211.     *  If the picture is larger than the screen the Up/Dn arrows  and  PgUp/PgDn
  212.        scroll the picture on the screen.  This only works  if  you  have  enough
  213.        video memory and your display card will write to video memory  not  being
  214.        displayed (Video 7 won't). VPIC doesn't scroll sideways;  see  'How  VPIC
  215.        Operates'.
  216.  
  217.                                                                          Page 4
  218.  
  219.  
  220.     VPIC COMMAND LINE OPTIONS - The DOS command line format for running VPIC is:
  221.        vpic [[path]filespec][/a /b /e /h /l /mN /r /v /w /xN /yN /z /?]   where:
  222.  
  223.     *  The default path is the current drive  and  directory,  and  the  default
  224.        extensions are BIF, BMP, CUT, GIF, IFF, LBM, MAC, PIC, PCX, SCx, and TGA.
  225.     *  The /a option starts VPIC in Auto resolution select mode.
  226.     *  The /b option causes VPIC to beep after displaying a file except in slide
  227.        mode or with /r.
  228.     *  The /e option starts VPIC in 16 color (EGA) mode.
  229.     *  The /h option allows the viewing of hidden files; great for R or X rated.
  230.     *  The /l option tells VPIC not to set the video mode. This is used to add a
  231.        picture to a picture already on the screen. Works best with /r /m /x /y.
  232.     *  The /mN locks the video resolution to mode N, where N is determined  from
  233.        the menu. The 256 color modes are 1 thru 10, and the 16 color  modes  are
  234.        11-20; ie, 320x200x256 is mode 1, 640x480x16 is mode 12.
  235.     *  The /r option immediately returns control  to  a  calling  program  after
  236.        displaying the picture. Calling program must reset text mode (mode co80).
  237.        VPIC returns an integer, and if negative means:
  238.             -1    Can't find the file specified.
  239.             -2    Not a valid picture file for the extension.
  240.             -3    File read or write error.
  241.             -4    Disk is full.
  242.             -5    Not enough memory for operation.
  243.             -6    An image in a GIF file is larger than the picture.
  244.             -7    Operation not supported.
  245.     *  The /v option disables VESA detection and uses the config file info.
  246.     *  The /w option wait for a keypress after each image in a  multi_image  GIF
  247.        file. Only works for multi-image GIFs.
  248.     *  The /xN option gives a left margin of N pixels. Only works  when  picture
  249.        is smaller than the screen.
  250.     *  The /yN option gives a top margin of N pixels for pictures  smaller  than
  251.        the screen.
  252.     *  The /z option inhibits printing the filename of each file when showing.
  253.     *  The /? option gives a help screen.
  254.     *  The /@xx option uses the commands in file xx to do a slideshow.
  255.     *  If filespec is a filename,  the single file will be  shown  (the  default
  256.        extension is GIF).
  257.     *  If path\filespec is a directory,  a menu of all  viewable  files in  that
  258.        directory will appear.  Otherwise all files  meeting  the  filespec  will
  259.        appear. For example, [vpic d:\pics\*.pcx] would give a menu  of  all  PCX
  260.        files in the PICS directory of drive D, while [vpic d:\pics]  would  give
  261.        a menu of all viewable files in the PICS directory of drive D.
  262.     Options and filespec may be entered in any order. The /r option  only  works
  263.     in single file mode, where all other work in menu or single file mode.
  264.  
  265.                                                                          Page 5
  266.  
  267.  
  268.     EXAMPLES OF VPIC COMMAND LINE OPTIONS
  269.  
  270.     1. VPIC [path\]filename[.ext] shows the single file specified.  The  default
  271.        path is the current directory, and the default extension is GIF.
  272.  
  273.     2. VPIC [path\][filespec] will give a menu of all  files  in  the  specified
  274.        path meeting filespec (may contain wildcards).  The default path  is  the
  275.        current directory, and the default filespec is any of the viewable files;
  276.        just entering VPIC will give a menu of all viewable files in the  current
  277.        directory.  If Path contains . or ..,  a  filespec  must  be  given  (may
  278.        contain wildcards). Thus ..\*.* would give a menu of all  viewable  files
  279.        in the parent of the current directory.
  280.  
  281.     3. VPIC /a starts VPIC in auto resolution mode.
  282.  
  283.     4. VPIC /b causes VPIC to beep after a file has been fully decoded. Lets you
  284.        know when the viewing options are available.  Doesn't beep in slide  mode
  285.        or when using the /r option.
  286.  
  287.     5. VPIC /e starts VPIC in 16 color modes; default is 256 color modes.
  288.  
  289.     6. VPIC /h allows VPIC to find and display hidden files in the  menu.  Great
  290.        for those R or X rated files you don't want to  be  normally  accessible.
  291.        This option doesn't appear on the help screen.
  292.  
  293.     7. VPIC /r filename[.ext] shows the filename picture and then returns to DOS
  294.        (or a calling application program) with the picture still on  the screen.
  295.        It is not necessary to change the video mode between viewing  each  file,
  296.        but it is up to the calling program to reset text mode (mode 3) after all
  297.        viewing is done. The /a, /e, /l, /m, /x, /y switches are valid with /r.
  298.  
  299.     8. VPIC /v gives a menu of the files in the current directory,  but  doesn't
  300.        look for VESA info from the display card. This is useful if the VESA info
  301.        is incorrect or doesn't support all the modes the card can do.
  302.  
  303.     9. VPIC /?  gives a help screen.
  304.  
  305.     10. VPIC /m3 /x0 /y0 /r file1 displays file1 in mode 3  in  the  upper  left
  306.        corner. Then, VPIC /r /l file2 /x320 /y200  displays  file2  starting  at
  307.        column 320 and row 200 leaving file 1 on the screen.
  308.  
  309.                                                                          Page 6
  310.  
  311.  
  312.     SLIDESHOWS
  313.  
  314.        VPIC /@[path\]slidefile[.ext] will do  a  slide  show  from  commands  in
  315.        slidefile. The default path is the current  directory,  and  the  default
  316.        slidefile extension is SLD. The path applies to both the slide  file  and
  317.        all files for viewing, so the slide file should be in the same  directory
  318.        as the viewable files. The commands are placed  on  separate  lines,  and
  319.        consist of either:
  320.        a. A filename (GIF extension assumed) and optional:
  321.           1. Display mode (number) and/or
  322.           2. Animate command (a followed by optional number with no spaces).
  323.        b. A delay (viewing time) spec of the form  d n (space required) where n
  324.           is the desired viewing time in seconds.
  325.        c. The statement QUIT to end the slideshow after 1 pass. QUIT may be
  326.           upper or lower case.
  327.  
  328.        The maximum number of files is 100. The number following the optional 'a'
  329.        is the number of vertical retraces between animation steps.  The  default
  330.        value is 8 (if no number follows the 'a'). The mode is explained below.
  331.  
  332.        To pause a slideshow press [SPACEBAR]; to end it press [ESC].
  333.  
  334.        The default viewing time is 5 seconds if no delay spec is given. A  delay
  335.        spec applies to all files following in the slide file until changed.  The
  336.        first slide is not delayed the  first  time  it  is  shown.  The  default
  337.        viewing mode is automatic (whatever fits).
  338.  
  339.        VPIC understands comments preceded by a semicolon, blank or comment lines,
  340.        and extra spaces.  For example,  the following slide  file  contents  are
  341.        understood by VPIC, but not recommended:
  342.  
  343.        d 20         ;Delay for file1.gif & file2.pcx is 20 seconds.
  344.        file1  1     ;First file in slideshow. File1.gif using mode 1.
  345.           file2.pcx ;This is a ZSoft filename with leading spaces.
  346.           ;This is a comment line with leading spaces, next is a blank line.
  347.  
  348.        d 10         ;File3 is delayed 10 seconds.
  349.        file3 a30    ;Show file 3, animate at 1 shift every 30 vertical retraces.
  350.           d      15 ;15 second delay file4.gif. Has leading & separator spaces.
  351.        file4        ;Show file4.gif for 15 seconds, then do file1.gif.
  352.  
  353.        The mode requires a little further explanation.  In the above slide file,
  354.        it says to use mode 1 with file1. Modes 1 thru 10 are the VGA (256 color)
  355.        modes, and modes 11 thru 20 are EGA (16 color) modes. Most display boards
  356.        only have a few of each type. The Orchid Designer has 4 VGA modes  and  4
  357.        EGA modes which appear in the file menu.
  358.  
  359.        The VGA modes are                  ║ The EGA modes are
  360.         1. 320x200x256     2. 640x350x256 ║ 11. 640x350x16     12. 640x480x16
  361.         3. 640x480x256     4. 800x600x256 ║ 13. 800x600x16     14. 1024x768x16
  362.  
  363.        Thus, the slide file says to show file1 in the 320x200x256 mode, and show
  364.        all the others in the default modes (whatever fits).
  365.  
  366.                                                                          Page 7
  367.  
  368.  
  369.     DETAILED COMMAND LIST - The following gives details & peculiarities of the
  370.     various commands.
  371.  
  372.     Keyboard and Mouse Menu Mode Commands.
  373.  
  374.     1.  The [up], [down], [right], and [left] arrow keys move the cursor  around
  375.         the menu of files. [PgDn/PgUp] goto next/previous page. Pressing  a  key
  376.         goes to next file starting with this character.  The  PgUp/PgDn  area in
  377.         the lower right corner allow the mouse to change pages.
  378.  
  379.     2.  Pressing the [SPACEBAR or the right  mouse  button]  marks  a  file  for
  380.         viewing or slides, and [SPACEBAR] moves to the next file; it  will  also
  381.         unmark a previously marked file.
  382.  
  383.     3.  Pressing [ENTER or the left mouse button] will display the marked  files
  384.         in the order they were marked. If no files were marked,  pressing  enter
  385.         or the left mouse button displays the file at the cursor.
  386.  
  387.     4.  Pressing [F1] will bring up the help screen; any key will return to  the
  388.         menu.
  389.  
  390.     5.  Pressing [F2] will do a slide show  of  marked  files  until  [ESC]   is
  391.         pressed.
  392.  
  393.     6.  Pressing [F3] will display the file size, colors,  and filetype  on  the
  394.         prompt/message line.
  395.  
  396.     7.  Pressing [F4] will toggle between 256 (VGA) and 16 color (EGA) modes.
  397.  
  398.     8.  Pressing [F5/F6] will decrease/increase the default resolution for  file
  399.         viewing.  In VGA, the default resolution  320x200  pictures  is  320x200
  400.         unless 'lock' [F7] is invoked.
  401.  
  402.     9.  Pressing [F7] goes to LOCK, which forces the default resolution  (above)
  403.         no matter what the file size.  Pressing F7 again  goes  to  AUTO,  which
  404.         automatically selects a resolution which will display the whole picture.
  405.         Pressing F7 again goes back to the normal default mode.
  406.  
  407.     10. Pressing [F8] toggles the wait mode,  where  VPIC  waits for a keypress
  408.         between multiple images in a GIF file.
  409.  
  410.     11. [F9] prompts for a new path\filespec, and displays a menu of  the  files
  411.         in the new path meeting the filespec.
  412.  
  413.     12. [F10] displays the current path on the prompt/message line.
  414.  
  415.     13. [Alt D] prompts for a new slide [F2] delay time in seconds.
  416.  
  417.     14. [Alt X] prompts if you want to delete the file at the cursor.  [Y]  will
  418.         delete it, [N] or ESC doesn't, and all other keys are ignored.
  419.  
  420.     15. Pressing [ESC] ends the program and returns to DOS.
  421.  
  422.     16. Pressing [Ctrl-Break] or [Ctrl-C] will get you  directly  to  DOS  from
  423.         anywhere.
  424.  
  425.     All other keys are ignored.  If errors are  encountered,  an  error  message
  426.     appears on the third line from the bottom, and disappears when the cursor is
  427.     moved. The amount of far memory available is also printed on the  same line.
  428.     The menu title is the search spec.
  429.  
  430.                                                                          Page 8
  431.  
  432.  
  433.     Keyboard Commands while Viewing a Picture (except in slide mode)
  434.  
  435.     *   The up/down arrow keys will scroll the picture by  one  line  if  it  is
  436.         longer than the screen, provided you  have  sufficient  display  memory.
  437.         The [PgUp] and [PgDn] keys will scroll by 10 lines. The Video 7 extended
  438.         VGA boards do not  support writing to non-displayed memory or  scrolling
  439.         pics larger than the screen, so this  function  is  disabled  for  these
  440.         boards. Straight VGA boards can't scroll in 320x200x256 mode because the
  441.         picture takes up all of display memory. VPIC will not  scroll  sideways;
  442.         see 'How VPIC Operates'.
  443.  
  444.     *   If the picture size is <= 1/2 the screen width, pressing [2]  will  give
  445.         a double size image (which may be scrollable) and pressing [1] will give
  446.         the normal size again. For VGA, the picture will be changed only in  the
  447.         horizontal direction; this will unsquash some 320x400 pics so the aspect
  448.         ratio is correct.
  449.  
  450.     *   Pressing [+] will increase the resolution (320x200 to 640x480, etc).
  451.  
  452.     *   Pressing [-] will decrease the resolution; useful if 800x600 rolls.
  453.  
  454.     *   Pressing [/] or [?] gives a help screen of commands available while viewing.
  455.  
  456.     NOTE: The file conversion options won't work when viewing a Targa  in  32000
  457.         colors with the Sierra DAC.  All the following conversion options  check
  458.         if the default filename is present, and prompt for a new name if it  is.
  459.         They create a file on the current drive  and  directory  with  the  same
  460.         dimensions as the file being viewed. If you screw up at the new filename
  461.         prompt,  hit [Ctrl-C] to escape immediately to DOS;  this  will  usually
  462.         preserve a file you don't want to write over. The safest bet is to  view
  463.         files in another directory, since the new file is saved  to the  default
  464.         directory,  which is the drive and directory you ran VPIC  from.  I  put
  465.         VPIC in my UTIL directory,  and have my PATH set to include UTIL,  so  I
  466.         can run VPIC from any drive or directory.
  467.  
  468.     *   Pressing [A] will 'animate' a picture by rotating the palette  periodic-
  469.         ally. This is especially effective on fractals, where large  areas  tend
  470.         to be the  same  color.  Pressing  [SPACEBAR]  will  pause  the  palette
  471.         rotation,  and pressing [ENTER] will terminate  it  and  return  to  the
  472.         command mode. Thus, by waiting for an especially nice pattern  and  then
  473.         pressing [ENTER], the pattern can be written to a file  using  the  file
  474.         save commands. Pressing [ESC] will return  to  the  menu.  The  rate  of
  475.         palette rotation can be  increased/decreased  with  the  up/down  arrows
  476.         (slow) or PgUp/PgDn (fast).
  477.  
  478.     *   Pressing [B] will convert a color VGA picture to a 64 shade gray picture.
  479.         The resulting image can be saved with the gray palette.  Only  works  in
  480.         VGA. The original palette cannot be restored with [Alt F10] after [B].
  481.  
  482.     *   Pressing [C] will create a Dr. Halo CUT file with the same  filename and
  483.         extension CUT. A palette file (.PAL) will also be created.
  484.  
  485.     *   Pressing [D] will create a Deluxe Paint II (Electronic Arts) file.  VPIC
  486.         will prompt for a normal or enhanced DP II file.
  487.  
  488.                                                                          Page 9
  489.  
  490.  
  491.     *   Pressing [E] will expand a  Run Length Encoded  (RLE)  compressed  Targa
  492.         file. If the file is not a Targa or is already  uncompressed,  this  key
  493.         does nothing.
  494.  
  495.     *   Pressing [F] will prompt for a new filename to overlay on  the  existing
  496.         picture. It also prompts for x and y offsets (in pixels). The colors may
  497.         not be exactly correct since the new picture uses a best  match  to  the
  498.         palette of the original picture, and some colors may  be  missing.  This
  499.         feature is handy for building composite pictures; ie, four 320x200  pics
  500.         on a 640x400 screen with the screen size 'locked' using F7 or /m on  the
  501.         command line. Specify where you want to place the first picture  on  the
  502.         command line when VPIC is executed using the /x and/or the  /y  options;
  503.         the filename display is suppressed using the /z option  on  the  command
  504.         line.  Alternately, you can have an  all  black  picture  as  the  first
  505.         picture, then overlay the others onto it. The composite picture can then
  506.         be saved in any of the file formats VPIC supports. You can also  specify
  507.         the /mN resolution mode from the command line to lock the video mode  to
  508.         the desired composite size; it can be changed once you are in the  menu.
  509.         Later pictures use the first pictures palette (if all are 256 color), so
  510.         it's a good idea to pick the first picture  with  the  widest  range  of
  511.         palette colors; this gives the best rendition of the other  pictures.  A
  512.         good way to invoke VPIC for this mode is `vpic /x0 /y0 /z /m3'.
  513.  
  514.     *   Pressing [G, I, M, U, <, or >] will create a GIF  file  on  the  default
  515.         drive, and prompt for a new filename; the default extension is  GIF. [G]
  516.         is for non-interlaced, and [I] is for  interlaced,  [M]  is  for  mirror
  517.         image, [U] is for upside down (inverted), [<] is rotate image 90 degrees
  518.         CCW, and [>] is rotate image 90 degrees CW.
  519.  
  520.     *   Pressing [P] will create a PC Paint or Pictor file.  The default  exten-
  521.         sion is PIC, and for EGA it prompts for a PC Paint or Pictor file.
  522.  
  523.     *   Pressing [R] will create a ColoRix  file  with  the  same  filename  and
  524.         extension SCx where x is a function of the screen size. If in EGA,  will
  525.         prompt if you want an EGA Paint or ColoRix file.
  526.  
  527.     *   Pressing [T] will create a Targa 16 or 24 file with  the  same  filename
  528.         and extension TGA. VPIC defaults to Targa 16, and prompts for Targa 24.
  529.  
  530.     *   Pressing [W] will create a Microsoft Windows Bitmap  file.  The  default
  531.         extension is BMP and it prompts for a compressed or uncompressed file.
  532.  
  533.     *   Pressing [Z] will create a ZSoft  (PC Paintbrush)  file  with  the  same
  534.         filename and extension PCX. The file will be in whatever  mode  you  are
  535.         currently using (EGA or VGA). The VGA palette will be  correct  for  the
  536.         latest version of PC Paintbrush, which saves a VGA palette in the file.
  537.  
  538.     *   [Alt_F] displays the current filename momentarily.
  539.  
  540.     *   Pressing [Alt-X] will prompt you to delete  the  current  file.  If  you
  541.         answer [y] it will be deleted, [n] or ESC it won't, and all  other  keys
  542.         are ignored.
  543.  
  544.                                                                          Page 10
  545.  
  546.  
  547.     *   Pressing [ENTER] will return to the menu or DOS, or show next  file  for
  548.         marked menu mode.
  549.  
  550.     *   Pressing [ESC] will end the display and return to the menu.
  551.  
  552.     *   The following keys control the picture tone as follows:
  553.         [F1]       Decrease red content of picture.
  554.         [F2]       Increase red content of picture.
  555.         [F3]       Decrease green content of picture.
  556.         [F4]       Increase green content of picture.
  557.         [F5]       Decrease blue content of picture.
  558.         [F6]       Increase blue content of picture.
  559.         [F7]       Decrease contrast of picture (VGA only).
  560.         [F8]       Increase contrast of picture (VGA only).
  561.         [F9]       Decrease brightness of picture (VGA only).
  562.         [F10]      Increase brightness of picture (VGA only).
  563.         [Alt-F10]  Restore original palette after you  thoroughly  mess  up  the
  564.                    colors. Doesn't work after a [B] grey shade conversion.
  565.         [V]        Reverses the current palette;  interesting effect  especially
  566.                    for black & white images.
  567.  
  568.         After a little experimenting, a 'washed out' VGA picture can be  greatly
  569.         improved by using [F1-F10],  and you can  always  start  over  by  using
  570.         [Alt-F10]. To retain a black background in a VGA picture, the brightness
  571.         should be decreased when the contrast is decreased.  If you have  really
  572.         improved the picture, you can then save it any of the supported formats.
  573.         VPIC will prompt you if the file exists in the  default  directory,  and
  574.         you have the option of overwriting it or giving  a  new  filename.  This
  575.         works really well with images created on  the  Sharp,  Howtec  or  Targa
  576.         scanners, which are sometimes 'washed out'.
  577.  
  578.     All other keys are  ignored.  Pressing  [Ctrl-Break]  or  [Ctrl-C]  will  go
  579.     directly to DOS.
  580.  
  581.                                                                          Page 11
  582.  
  583.     DECODING OTHER FILE FORMATS
  584.  
  585.     Each picture is viewed in whatever mode you are presently using (VGA or EGA)
  586.     and at the resolution you have selected. If you choose to  save  to  another
  587.     file format which differentiates between VGA  and  EGA  modes,  it  will  be
  588.     converted using the appropriate rules.  This makes  EGA <-> VGA  conversions
  589.     possible, which is not supported by most paint programs.
  590.  
  591.     The decoding for other than GIF is not as fast as could  be  done,  but  the
  592.     added versatility more than compensates for this. For example, EGA PCX files
  593.     can be very quickly decoded to EGA, but are in the wrong format for VGA, and
  594.     considerable manipulation is required  to  produce  a  VGA  image.  For  all
  595.     formats, the method of viewing is to decode to a buffer for a single line at
  596.     1 byte/pixel, then copy this line to the display in whatever  mode  you  are
  597.     using. This is a compromise for most file formats, since they are geared  to
  598.     EGA or VGA, and display time suffers, but it makes the  code  much  simpler.
  599.     Besides, the other formats are supported mainly to allow easy conversion  to
  600.     GIF, which is the preferred format for storage since it gives  the  smallest
  601.     file size.
  602.  
  603.     The TARGA viewing (except with the Sierra DAC) uses a fixed palette to speed
  604.     up the decoding, so the picture does not have good color  rendition.  It  is
  605.     mainly there to verify that an image is present. Use Pegasus Imaging  Corp's
  606.     SHOWFRAC to make a Targa 8 with excellent color rendition, and then  convert
  607.     this to GIF using VPIC.
  608.  
  609.     ADDED FEATURES
  610.  
  611.     VPIC is meant to fill a void not covered by paint  programs,  and  to  allow
  612.     very convenient file viewing and conversion between file formats. It is  not
  613.     meant to compete with the paint programs, and in general if a paint  program
  614.     does something well (such as resize a picture to fill the screen or cut  out
  615.     a portion of the picture), VPIC will not attempt to  do  it.  On  the  other
  616.     hand, if you think of a feature which would  enhance  VPIC,  please  let  me
  617.     know, and I will consider adding it to the program.
  618.  
  619.     KNOWN PROBLEMS
  620.  
  621.     1. The ATI VGA Wonder 1024x768x16 mode and all the S3 16 color modes  use  2
  622.        pixels/byte, unlike any other VGA or EGA mode.  It is supported for  most
  623.        viewing and conversions, but will not view or convert to EGA Paint files,
  624.        ColoRIX EGA files, or Pictor EGA files, since these are on an  EGA  plane
  625.        basis.
  626.     2. If you have a board with the Trident TVGA 8900 VGA chip, don't run MAMODE
  627.        before running VPIC, or run MAMODE 64 if you were in a 128K bank mode.
  628.  
  629.                                                                          Page 12
  630.  
  631.  
  632.     SUPPORT FOR OTHER SUPERVGA BOARDS
  633.  
  634.     I will try to support other VGA boards with extended VGA modes if the owners
  635.     will write me with the details of how to set the various modes, and  how  to
  636.     bank switch the display memory. Of course, if you also register VPIC I  will
  637.     give the problem more consideration.  Use of a board  is  almost  mandatory,
  638.     since I can't tell if the new routines work unless I can try them.
  639.  
  640.     The bank switching Info for some of the 'not so common' VGA boards  is  hard
  641.     to come by, and is needed if VPIC is to support extended VGA modes for these
  642.     boards. A VGA board needs to bank switch for extended modes because there is
  643.     only a 64K window in the PC address space for graphics memory (from A000  to
  644.     AFFF),  and extended modes require more  than  64K  of  memory;  640x480x256
  645.     requires 307200 bytes of memory, or about 4.7 'banks of 64K'. Bank switching
  646.     is a means of mapping the (A000 to AFFF) graphics  address  space  into  64K
  647.     chunks of actual display memory. The method of bank switching is  determined
  648.     by the VGA chip used on the display board, and what I need is info on how to
  649.     switch banks and how to set the various modes the board supports.
  650.  
  651.                                                                          Page 13
  652.  
  653.     HOW VPIC OPERATES
  654.  
  655.     VPIC decodes a picture file directly to screen memory on your display  card.
  656.     The other technique is to decode to CPU (normal) memory and then  copy  the
  657.     picture (or a portion of it) to screen memory. Both ways have their  advan-
  658.     tages and disadvantages.
  659.  
  660.     DECODING DIRECTLY TO SCREEN MEMORY (LIKE VPIC).
  661.  
  662.     ADVANTAGES - This method offers the best speed, since it  doesn't  have  to
  663.     go thru the intermediate step of decoding to  CPU  memory  first.  It  will
  664.     also always decode large pictures, even above  the  maximum  display  size.
  665.     The CPU method usually doesn't  have  sufficient  memory  for  large  pics,
  666.     like 1024x768x256, or even 800x600x256 if you have  any  TSR's  in  memory;
  667.     these pics require 1 byte/pixel.
  668.  
  669.     The file conversion options uses the current palette data and  the  current
  670.     data in display memory to make the new file. Thus, what  you  see  is  what
  671.     you get in a new file format, in whatever mode you are  viewing  (256 or 16
  672.     color).
  673.  
  674.     DISADVANTAGES - Because the picture is decoded directly to  screen  memory,
  675.     any picture data beyond the right edge of the screen is  thrown  away.  For
  676.     this reason, you can't scroll left and right. VPIC will continue to  decode
  677.     to display memory beyond the bottom of the screen  until  it  runs  out  of
  678.     memory, set by BANKS in the configuration file.  If the card  wraps  memory
  679.     beyond the bottom of the screen back onto the  screen,  like  the  Video  7
  680.     cards, then VPIC doesn't decode beyond the screen bottom.
  681.  
  682.     Thus, if your display card doesn't wrap display memory, you will be able to
  683.     scroll the picture up and down.
  684.  
  685.     If the screen doesn't display the whole picture width, any  converted  file
  686.     will be truncated on the right edge to the screen size.
  687.  
  688.     DECODING TO CPU MEMORY FIRST
  689.  
  690.     ADVANTAGES - If there is sufficient CPU memory to hold the whole picture (at
  691.     1 byte/pixel), a rectangular area equal to the screen size can be copied  to
  692.     display memory, which allows  you  to  scroll  around  the  picture  in  all
  693.     directions.
  694.  
  695.     DISADVANTAGES - If there is not sufficient CPU memory, most of the  programs
  696.     will refuse to display the  picture.  There  is  also  the  wait  while  the
  697.     picture is decoded to CPU memory before you get to see it.
  698.  
  699.                                                                          Page 14
  700.     VPIC TERMS AND CONDITIONS
  701.  
  702.     NOTICE - VPIC is not free software. If you paid a "public domain" vendor for
  703.     this program, you paid for the copy and mailing service only,  and  not  for
  704.     the program itself. Nothing ever gets to the author of the program from such
  705.     a sale.  You may evaluate VPIC, but if you find it useful, you should regis-
  706.     ter your copy.   There are several incentives for supporting VPIC.   You get
  707.     free technical support, which can be quite valuable at times. You also allow
  708.     me to stay in business, and improve the program;  it has been evolving since
  709.     1987,  and new features and/or video card support are added with each revis-
  710.     ion.
  711.  
  712.     VPIC is copyrighted software, and all rights are reserved. VPIC may not  be
  713.     changed or modified in any way except by the author. VPIC is SHAREWARE, and
  714.     may be freely distributed, as long as it remains in its complete form  with
  715.     all support, documentation, and configuration files. It may be used  for  a
  716.     ten day free trial period.  Regardless of how the copy is obtained,  it  is
  717.     requested that all users comply with the  following  licensing/registration
  718.     provisions if they continue to use it after the 10 day trial period:
  719.  
  720.     1.  a. $1/copy royalty if used as part of a DEMO; a demo is not part of your
  721.            product, but is a means of advertizing your product.
  722.         b. $2/copy royalty if used as a utility for running your product.
  723.         The maker of  the  demo/product  should  be  a  registered  user.  If  a
  724.         recipient of the disk uses VPIC for other purposes (not part of the demo
  725.         or product) he should register. You should sign a royalty agreement with
  726.         me, and make payments annually. You may estimate the yearly  usage,  and
  727.         then correct it from year to year.  You should supply to  me  a  written
  728.         statement listing the copies shipped each year.
  729.     2.  $15 per copy for individual users.  Users can feel free to use VPIC  for
  730.         anything. I need your name and address  for  my  records,  and  you  are
  731.         entitled to:
  732.         a.  Use all updates at no cost (except shipping and handling; see below)
  733.             provided the registration fee hasn't changed..
  734.         b.  Technical support either by phone (you call me) or by letter.
  735.     3.  Quantity discounts:
  736.             10 to 99: $10 per copy.
  737.             100 up: $7.50 per copy.
  738.             All registered users can feel free to use  VPIC  for  anything.  You
  739.             should supply me the names and addresses of the users so I can honor
  740.             update requests and provide technical support on an individual basis
  741.             as in 2.
  742.     4.  Site License: $75 per 10 copies if used or distributed  by  you,  or  as
  743.         part of your product. All users would be registered  collectively  under
  744.         your name, but can fell free to use VPIC for anything.  Update  requests
  745.         and technical support would be thru you (since I don't know the names of
  746.         the individual users) and would be distributed by you to the users.
  747.     5.  Clubs, schools,  universities and  other  non-profit  organizations  may
  748.         license VPIC for $45.00 per 6 copies.  All  users  would  be  registered
  749.         collectively under your  name,  but  can  feel  free  to  use  VPIC  for
  750.         anything. Update requests and technical support would be thru you, since
  751.         I don't know the names of the individual users, and would be distributed
  752.         by you to the users.
  753.  
  754.     For foreign orders, please send a check drawn on a US Bank, International or
  755.     US Postal Money Order, Travelers Checks, or cash, since the banks charge  up
  756.     to $60 collection fee for foreign checks.
  757.  
  758.                                                                         Page 15
  759.  
  760.  
  761.     For all the above, VPIC should be distributed intact, with all documentation
  762.     (DOC files), support programs (CVPIC, CONFIG, and WHICHVGA),  and  configur-
  763.     ation (.CFG) files. Archived form is OK to meet this requirement,  since  it
  764.     minimizes disk space, if you supply the un-archiving program.
  765.  
  766.     A user may install VPIC on more than one machine, provided he  is  the  only
  767.     user on each machine. The registration and license policy is  similar  to  a
  768.     book, which can be taken with you but used only by you.
  769.  
  770.     Please use the enclosed registration/order form since it allows me  to  keep
  771.     better records and keep up with the newer VGA boards.
  772.  
  773.  
  774.     UPGRADES FROM PREVIOUS PROGRAMS AND UPDATES
  775.  
  776.     You may use all updates (with the same registration fee) free once you  have
  777.     registered VPIC. If you are already registered for VGIF or ZS  (any version)
  778.     you may upgrade to  VPIC  for  an  additional  $5.  Since  VPIC  is  updated
  779.     regularly, I do not send  notices,  but  it  gets  around  quickly  to  most
  780.     graphics oriented BBS's, and is available at Compuserve in Data Library 3 of
  781.     the PICS forum.
  782.  
  783.     ORDERS FROM ME
  784.  
  785.     If you order VPIC, an upgrade, or an update from  me,  please  add  $5  ($10
  786.     outside the USA and Canada) for materials, postage, and handling. As a bonus
  787.     I will fill the rest of the disk with good pictures. Please specify 360K  or
  788.     1.2Meg 5.25" disk or 1.44M 3.5" disk, and EGA, VGA, or SuperVGA (640x480x256
  789.     etc) so I'll know what pictures to send. I have three 1024x768x256 pictures,
  790.     but each is about 700K in size and eats up a sizeable portion of a disk,  so
  791.     if you want one of these there wont be much room for other pictures. If  you
  792.     want additional disks of pictures, please add $5/disk. I have  quite  a  few
  793.     640x480x256 pictures  (mostly  by  Boris  Vallejo),  only  1  disk  full  of
  794.     320x200x256 pictures and 1 disk of EGA pictures, and a few larger sizes.
  795.  
  796.     Even if you can't read a 1.2 Meg disk, I would  recommend  getting  VPIC  on
  797.     that size, since you get about 1 Meg of picture files that way. Then, have a
  798.     friend (or computer store) copy the files to your disks.
  799.  
  800.     Data on the various file formats VPIC supports  is  available  free  if  you
  801.     request it with your order, but will use about 200K of disk space.
  802.  
  803.     Please use the enclosed registration/order form since it allows me  to  keep
  804.     better records and keep up with the newer VGA boards.
  805.  
  806.     DISCLAIMER
  807.  
  808.     All warranties are disclaimed, including damage to hardware and/or  software
  809.     from use of this product. In no event will I be liable to you for any damages,
  810.     including lost profits, lost savings or other  incidental  or  consequential
  811.     damages arising out of your use or inability to  use  the  program,  or  any
  812.     other claim by any other party.
  813.  
  814.                                                                         Page 16
  815.  
  816.  
  817.     SPECIAL VERSIONS
  818.  
  819.     Contact Bob Montgomery for:
  820.         1. Special versions of VPIC tailored to your application.
  821.         2. Other graphics oriented applications (file conversion, etc).
  822.  
  823.     Any suggestions or comments should be mailed directly to me.  The following  are
  824.     graphics oriented BBS's:
  825.  
  826.  
  827.     GRAPHICS ORIENTED BBS'S
  828.  
  829.     Compuserve PICS Forum (My ID is 73357,3140)
  830.     Magic City USA, Orlando, Florida 1.0 Gig Online
  831.         Modems: 2400 baud (407) 628-2546,  HST (407) 628-0185
  832.     Tsunami BBS, Half Moon Bay, Calif. (415) 726-2726
  833.     PC Rockland, S. Nyack, NY (914) 353-2538 [Freeboard] 1.6 Gbyte Online
  834.     Megabyte Image Center     (918) 492-0087 1200/2400/9600 baud USR HST
  835.     Pictures and Scanning Services:
  836.     Event Horizons: Catalog, 311 Avenue "B", Suite 209, Lake Oswego, OR 97034
  837.       Order:503-697-7700, Modems:(1200/2400) 503-697-5100, (9600HST) 503-697-5126
  838.     JPix Graphics Imaging: Modems:(2400) 219-267-2188, (9600) 219-267-8528
  839.  
  840.                                                                         Page A1
  841.  
  842.  
  843.                       APPENDIX A - REVISION HISTORY
  844.  
  845. History of the original VGIF program.
  846.  
  847.     VGIF ver 1.1   1-13-88
  848.         *  Added test for EGA adapter.
  849.         *  Fixed menu colors.
  850.         *  Allow [ESC]ape from marked file viewing.
  851.         *  Added [Ctrl-Break] or [Ctrl-C] exit to DOS anywhere.
  852.         *  Added 'disk full' notification when creating picture file.
  853.         *  Added critical error handler for 'drive not ready' errors.
  854.  
  855.     VGIF ver 1.2   1-15-88
  856.         *  Changed name to VGIF.
  857.         *  Slide mode now ignores the end of file mark in slide  file,  and  any
  858.            key will now end slide mode.
  859.         *  Added slides to menu mode if [S] pressed-shows marked files as slides
  860.            until a key is pressed.
  861.  
  862.     VGIF ver 1.3   1-21-88
  863.         *  Added better error checking to GIF file decoding. Notifies if bad GIF
  864.            file.
  865.         *  Fixed error reporting bug in single file mode.
  866.  
  867.     VGIF ver 1.4   2-9-88
  868.         *  Added instantaneous screen update in slide mode from menu or  command
  869.            (SLD) file.
  870.         *  Added the /r option which allows an application program to call  VGIF
  871.            to view a file and then regain control.
  872.  
  873.     VGIF ver 1.5   3-2-88
  874.         *  Added [PgUp] and [PgDn] keys to scroll by 10 lines at a time.
  875.         *  Added a max pic height of 819 lines so EGA buffer would not  overflow.
  876.         *  Greatly improved color reproduction for 'problem' pictures  (such  as
  877.            FROG, ARCHIT, PUFFIN, VEGTABLE, etc). These pictures  typically  have
  878.            more than 16 colors. Selected colors on basis  of  frequency  of  use
  879.            where possible.
  880.         *  Fixed following bugs:
  881.            1.  Line buffer would overflow into other variables if pic width  was
  882.                > 640 pixels, causing strange results.
  883.            2.  Didn't recognize the end of image marker  correctly.  This  would
  884.                cause the palette to change when the image was done.
  885.  
  886.     VGIF ver 1.6   3-11-88
  887.         *  Fixed a bug in handling multiple images. First noticed  when  viewing
  888.            WHIMMI.GIF.
  889.         *  Use same palette for multiple images, and get best color match.
  890.         *  Added [L] and [S] commands while viewing a picture. These  allow  you
  891.            to create full size paint program files.
  892.     
  893.                                                                         Page A2
  894.  
  895.  
  896.     VGIF ver 2.0   3-26-88
  897.         *  Added the ability to view long GIF files ( > 819 lines) without
  898.            wrapping the display.
  899.         *  Added the [C] and [H] (Dr. Halo) file creation option while viewing.
  900.         *  Added the [L] and [S] prefixes to paint program file creation commands
  901.            while viewing to save long pic files.
  902.         *  Added the Info and Help commands in menu mode.
  903.         *  Deleted the # requirement to specify a directory from the command
  904.            line. The program now looks for a directory which meets the  spec  on
  905.            the command line. If none is found, it assumes  the  spec  is  for  a
  906.            single file.
  907.         *  Added [F1 - F10], and [V] palette control keys while viewing a file.
  908.  
  909.     VGIF ver 3.0   5-2-88
  910.         *  Added VGA capability, and support for Tseng extended VGA modes
  911.            (640x480x256 and 800x600x256).
  912.         *  Determines and displays available modes for your system.
  913.  
  914.     VGIF ver 3.1   5-11-88
  915.         *  Fixed a bug in dir/file spec from command line. Now accepts
  916.            VGIF d:\dir\*.gif or VGIF  d:*.gif,  although  the  [\]*.gif  is  not
  917.            required, since this is the default filespec.
  918.  
  919.         *  Fixed a bug in forced EGA when doing slides, where an interlaced  pic
  920.            displayed at double size would have a 'venetian blind' effect.
  921.  
  922.         *  Changed so pics larger than 320x200 are shown in 640x480 VGA; can get
  923.            800x600 by pressing + key.
  924.  
  925.         *  The EGA mode on the Orchid VGA card appears squashed vertically. This
  926.            is normal, and cannot be corrected without  reprogramming  the  para-
  927.            meters for mode 16, which would change the vertical retrace frequency
  928.            and probably cause your monitor to roll.
  929.  
  930.     VGIF ver 3.2   5-26-88
  931.         *  Added 500 file menu, and assy language  text  screen  updating;  now
  932.            super fast.
  933.         *  Fixed a bug which caused the Vega VGA card to hang up.
  934.  
  935.     VGIF ver 3.3   6-9-88
  936.         *  Added user spec of video mode for non-Orchid VGA boards.
  937.         *  Added GIF and Pictor save of current screen for VGA/EGA pics.
  938.         *  Added prompts to screen for conversion to other formats.
  939.         *  Removed conversion starting at first visible row-now does whole pic.
  940.  
  941.     VGIF ver 3.4   6-23-88
  942.         *  Fixed a bug in the GIF save routine.
  943.         *  Added color, contrast, and brightness adjustment in VGA.
  944.         *  Fixed a bug in menu mode for marked files.
  945.         *  Added /n command line option to stay in 640x480x256 for VGA pics.
  946.  
  947.     VGIF ver 3.5   7-14-88
  948.         *  Fixed some misc minor bugs.
  949.         *  Added increase/decrease resolution command while viewing 16 color VGA
  950.            pics (using the /e option).
  951.         *  Added slide mode for VGA.
  952.         *  Added lock mode option to start pics from the menu in a desired mode.
  953.  
  954.                                                                         Page A3
  955.  
  956.  
  957.  
  958.     VGIF ver 3.6   8-8-88
  959.         *  Fixed some bugs.
  960.         *  Fixed EGA slide show.
  961.  
  962.     VGIF ver 3.6A  9-10-88
  963.         *  Fixed 1024x768x16 mode.
  964.  
  965.     VGIF ver 4.0   10-20-89
  966.         *  This was a beta test version which got out.  It  had  lots  of  bugs,
  967.            which were fixed in VPIC.
  968.  
  969.     HISTORY OF VPIC
  970.  
  971.     VPIC ver 1.0 & 1.1 12-27-88
  972.         *     Beta test versions.
  973.  
  974.     VPIC ver 1.2   12-27-88
  975.         *  Added configuration option for various display boards.
  976.         *  Added VGA file conversion for all previous Paint programs supported.
  977.         *  Added Deluxe Paint 2 conversion.
  978.         *  Added Targa 16 file conversion.
  979.         *  Added EGA/VGA toggle from menu.
  980.         *  Added default resolution select, and Mode Lock key from menu.
  981.         *  Added WAIT option to pause between images of multi-image files.
  982.         *  Added MAC, PCX, & Colorix file viewing  capability.  Others  will  be
  983.            added in later versions.
  984.         *  Added 'animate' while viewing.
  985.         *  Fixed VGA 16 color palette.
  986.  
  987.     VPIC ver 1.2A   1-4-89
  988.         *  Fixed MAC -> GIF conversion
  989.         *  Fixed CVPIC for ^Z as EOF char.
  990.         *  Fixed 16 color palette for other file formats if VGA 16 colors.
  991.  
  992.     VPIC ver 1.3    2-2-89
  993.         *  Fixed cursor in menu.
  994.         *  Fixed 'lock up' if GIF header size wrong (640x350 labeled 350x640).
  995.         *  Now pauses pic if file error and waits for key press-can see  partial
  996.            pics in bad files this way.
  997.         *  Shows GIFs with MAC headers (1st 128 bytes are not GIF standard);  if
  998.            F3 (info) pressed shows if file has a MAC header.
  999.         *  Fixed so views and saves  new  ZSoft  VGA  PCX  files  which  include
  1000.            palette at end of file. Still doesn't load PAL files.
  1001.         *  Fixed ZSoft file displays and saves.
  1002.         *  Added Wait toggle (F8) which pauses  between  images  in  multi-image
  1003.            GIFs, and allows conversion to other filetypes.
  1004.         *  Made MACs black on bright white instead of gray.
  1005.  
  1006.     VPIC ver 1.4   3-15-89
  1007.         *  Added printout of filename while decoding except in slide mode.
  1008.         *  Added help while viewing a picture; press [?] or [/].
  1009.         *  Added delete a file option [X] (with query) while viewing.
  1010.         *  Added hit [ESC] while decoding to abort picture.
  1011.  
  1012.                                                                         Page A4
  1013.  
  1014.  
  1015.     VPIC ver 1.5   3-23-89
  1016.         *  Fixed bug in 'Escape while decoding' which would hang system.
  1017.         *  Fixed EGA x2 display for interlaced files.
  1018.         *  Fixed problem with saving a pic after scrolling.
  1019.         *  Fixed palette in animate, so save will use current palette.
  1020.         *  Fixed problem with bad files in slide mode that would hang computer.
  1021.         *  Fixed error display in /@ slide mode and single file mode.
  1022.  
  1023.     VPIC ver 1.6   4-5-89
  1024.         *  Fixed bugs in slide show from command file. Added comments.
  1025.         *  Added resolution option for each picture in slide command file.
  1026.         *  Fixed miscellaneous minor bugs.
  1027.         *  Added configurable menu color.
  1028.  
  1029.     VPIC ver 1.7   6-13-89
  1030.         *  Added Trident chip set support (for Maxxon and Logix VGA  boards  and
  1031.            maybe the ATI board).
  1032.         *  Fixed a few bugs concerned with putting  &  getting  lines  from  the
  1033.            display  screen.
  1034.         *  Fixed problem with Ctrl Z at end of slide definition file.
  1035.  
  1036.     VPIC ver 1.8  6-28-89
  1037.         *  Added EGA Paint viewing/conversion.
  1038.         *  Fixed conversion to 800x600 ColoRIX file.
  1039.         *  Fixed other minor bugs.
  1040.  
  1041.     VPIC ver 1.9  7-19-89
  1042.         *  Added inverted, mirrored, and rotated GIF saves.
  1043.         *  Fixed a bug in the Dr Halo CUT file creation.
  1044.         *  Added menu updating after file creation or deletion.
  1045.         *  Added new path spec feature from menu with [F9] key.
  1046.  
  1047.     VPIC ver 2.0  8-6-89
  1048.         *  Added Pictor/PC Paint PIC, Dr. Halo CUT, Deluxe Paint LBM, and
  1049.            Targa 16 or 24 file viewing capability.
  1050.         *  Fixed a bug in the palette selection for EGA.
  1051.         *  Fixed bug which would not show VGA for the plain vanilla VGA config.
  1052.         *  Fixed a bug in the ZSoft PCX display for extended EGA modes.
  1053.         *  Added Auto resolution option and switch from the menu [F7].
  1054.         *  Made cursor stay fixed when files are created or deleted.
  1055.         *  Added Chips & Technology support. (VPIC 2.0A)
  1056.         *  Fixed ZSoft save at higher screen resolution than pic. (VPIC 2.0B)
  1057.  
  1058.     VPIC ver 2.1   9-5-89
  1059.         *  Fixed a bug in LBM viewing
  1060.         *  Added ColoRIX 16 color SCR and SCP view/create.
  1061.         *  Speeded up GIF decoding about 50%.
  1062.  
  1063.     VPIC ver 2.1A  9-10-89
  1064.         *  Fixed a memory allocation problem for slides.
  1065.         *  Made small increase in speed.
  1066.         *  Fixed directory callout (*.PIC, etc).
  1067.         *  Re-enabled [ESC] for GIF viewing.
  1068.         *  Fixed Chip & Tech bank switching routine.
  1069.         *  Fixed Deluxe Paint II (LBM) file creation.
  1070.  
  1071.                                                                         Page A5
  1072.  
  1073.  
  1074.     VPIC ver 2.2  10-23-89
  1075.         *  Fixed problem in new path command ([F9] from menu).
  1076.         *  Fixed intermittent GIF decode problem.
  1077.         *  Program now tells if GIF image and screen sizes conflict.
  1078.         *  Menu now correctly displays file sizes larger than 1 Mbyte.
  1079.         *  Now lists & displays Electronic Arts IFF files (same as LBM).
  1080.  
  1081.     VPIC ver 2.3  12-13-89
  1082.         *  Fixed C_T bank switching.
  1083.         *  Added Everex 678, Ahead (B chip), and Genoa 6400 support.
  1084.         *  Fixed bugs in GIF and Pictor decoder.
  1085.  
  1086.     VPIC ver 2.4  12-28-89
  1087.         * Fixed bug in GIF decoder for very wide pics.
  1088.         * Fixed palette for many file types.
  1089.         * Fixed slide mode from menu.
  1090.  
  1091.     VPIC ver 2.5  1-28-90
  1092.         * Fixed single file and /r modes.
  1093.         * Fixed Pictor viewing for B&W pics.
  1094.         * Fixed MAC header interpretation problem.
  1095.         * Fixed memory clearing for pictures longer than the screen.
  1096.         * Added F10 to menu to display current path. Menu no longer shows
  1097.           complete path (only filespec) to avoid clutter with long paths.
  1098.         * Deleted path from filename display when showing picture.
  1099.         * Added SCY conversion for ColoRIX.
  1100.         * Added Zymos VGA chip support.
  1101.         * Corrected CVPIC to allow more than 9 banks in config file.
  1102.  
  1103.     VPIC ver 2.6  1-28-90
  1104.         * Fixed palette for 2 color GIFs.
  1105.         * Fixed SCU display in 1024x768x16 mode.
  1106.         * Fixed Pictor EGA and ColoRIX EGA slide viewing.
  1107.  
  1108.     VPIC ver 2.7  3-17-90
  1109.         * Fixed GIF bug and palette for files with local color maps.
  1110.         * Added /b command line option to beep after a picture is decoded except
  1111.           in slide modes.
  1112.         * Added Alt_F command while viewing a picture to momentarily display the
  1113.           file name.
  1114.         * Fixed Targa viewing for all sizes; now handles RLE images too.
  1115.  
  1116.     VPIC ver 2.8  3-27-90
  1117.         * Added /h command line option to find hidden files.
  1118.         * Changed menu display to allow up to 8 modes for VGA or EGA.
  1119.         * Fixed palette in Dr. Halo CUT files.
  1120.         * Added Tseng 4000 chip support.
  1121.  
  1122.     VPIC ver 2.9  5-23-90
  1123.         * Fixed Targa module to handle all 8 thru 32 bits/pixel formats.
  1124.         * Added copyright messages.
  1125.         * Fixed PCX viewing for gray scale files.
  1126.  
  1127.                                                                         Page A6
  1128.  
  1129.  
  1130.  
  1131.     VPIC ver 2.9A 7-1-90
  1132.        *  Fixed Targa module for files which don't follow the compression  rules
  1133.           of 'don't overrun lines'. Added TGA expand option [E] while viewing  a
  1134.           RLE compressed Targa file.
  1135.        *  Fixed conversion routines so they save the pictures size. This  was  a
  1136.           bug that crept into ver 2.9.
  1137.        *  Added ESC to abort deleting a file with [Alt_X].
  1138.        *  Added file types (where applicable) to the info command [F3] from  the
  1139.           menu.
  1140.        *  Added uncompressed ColoRIX SCO file (1024x768x256) support.
  1141.        *  Fixed a bug in CVPIC.
  1142.        *  Fixed a bug which prevented working with DOS 4.x.
  1143.        *  Added Deluxe Paint II enhanced viewing and save capability.
  1144.        *  Fixed a color bug in Targa 32 viewing.
  1145.  
  1146.     VPIC ver 3.0  9-15-90
  1147.        *  Added capability to view the new GIF89a files, and FRA fractal files.
  1148.           Added delay and user response features of GIF89a.
  1149.        *  Fixed a bug which would hang the computer if you deleted the last
  1150.           viewable file from a directory.
  1151.        *  Added prompt for a file conversion, allowing you to escape.
  1152.        *  Added C&T, as well as the previous C_T, which VPIC will accept as  the
  1153.           Chips & Technologies VGA chip in the config file.
  1154.        *  Fixed memory allocation bug in PCX creation for 1024x768x256 images.
  1155.  
  1156.     VPIC ver 3.1  9-25-90
  1157.        *  Added flexibility to slide mode. Always  decodes  to  memory  and  can
  1158.           change delay for files; see the section on 'vpic /@slidesfile`.
  1159.  
  1160.     VPIC ver 3.2  10-29-90
  1161.        *  Fixed the bank switching for the Trident 8800 chip.
  1162.        *  Fixed a palette problem when viewing Targa files.
  1163.  
  1164.     VPIC ver 3.3  11-5-90
  1165.        *  Fixed problem with lines on VGA pics in slide mode.
  1166.        *  Added animate command in slide command file, and speed control for
  1167.           animation.
  1168.        *  Fixed MCGA 16 color palette.
  1169.        *  Fixed ATI 1024x768x16 slide mode.
  1170.  
  1171.     VPIC ver 3.4  11-21-90
  1172.        *  Fixed most conversion routines so they work in ATI 1024x768x16 mode;
  1173.           can't do EGA Paint or 16 color ColoRIX, or Pictor EGA files.
  1174.        *  Fixed most viewing routines so they work in ATI 1024x768x16 mode;
  1175.           can't do EGA Paint or 16 color ColoRIX, or Pictor EGA files.
  1176.        *  Fixed bugs in conversion for pics less than screen width wide.
  1177.        *  Cleaned up numerous small bugs.
  1178.        *  Added BIF Binary Image File from B&W image capture boards.
  1179.  
  1180.     VPIC ver 3.5  12-15-90
  1181.         *  Added 64 shade gray conversion for VGA images (press b while viewing).
  1182.         *  Added auto-centering for pictures smaller than the screen.
  1183.         *  For slides, now displays as much of picture as memory will allow.
  1184.  
  1185.                                                                         Page A7
  1186.  
  1187.  
  1188.  
  1189.     VPIC ver 4.0  02-13-91
  1190.         * Added GIF89a features including transparent color, variable size plain
  1191.           text, user input, variable delay, and display of  comments.  Works  in
  1192.           all EGA and VGA modes.
  1193.         * Fixed all file conversions so they work with centered images.
  1194.         * Improved palette selection, and made hi contrast help messages.
  1195.  
  1196.     VPIC ver 4.0a 02-20-91
  1197.         * Added OAK and new ATI (with normal 1024x768x16 mode) card.
  1198.         * Added `whichvga' program to try to identify your VGA chip.
  1199.  
  1200.     VPIC ver 4.1  03-15-91
  1201.         * Added Microsoft Windows 3.0 Bitmap BMP file viewing/saving in compres-
  1202.           sed or uncompressed format. Sometimes  uncompressed  is  smaller  than
  1203.           compressed.
  1204.         * Changed VGA chip designators, added VGA chips; see CONFIG.DOC. Be sure
  1205.           to use the version of CVPIC supplied with this version of VPIC.
  1206.  
  1207.     VPIC ver 4.2  04-10-91
  1208.         * Fixed palette bug which would reverse black and white in some pictures.
  1209.         * Fixed menu when disk was rescanned.
  1210.  
  1211.     VPIC ver 4.3  04-27-91
  1212.         * Added x and y offset, and inhibit filename display, from command  line
  1213.           using /x, /y, and /z options.
  1214.         * Added overlaying of pictures onto display using the 'F' command  while
  1215.           viewing a picture.
  1216.  
  1217.     VPIC ver 4.3a 05-05-91
  1218.         * Fixed ATI VGA Wonder scrolling.
  1219.  
  1220.     VPIC ver 4.3b 05-15-91
  1221.         * Fixed EGA palette.
  1222.  
  1223.     VPIC ver 4.4  07-09-91
  1224.         * Added mouse support for the menu screen (so far).
  1225.         * Added Viewpoint picture viewing (.PIC files).
  1226.         * Added wider selection of menu colors; see CONFIG.DOC.
  1227.         * Added a mode set from the command line.
  1228.         * Added 1280x1024 EGA modes (DEFINICON.CFG)
  1229.         * Fixed a bug in the BMP decoder for OS/2 PM files.
  1230.         * Fixed a bug in slides mode.
  1231.  
  1232.     VPIC ver 4.5  08-05-91
  1233.         * Added full VESA autodetect and use for all 16 and 256 color modes.
  1234.         * Added mouse support in the menu.
  1235.         * Added Tseng ET-4000 HiColor (32K colors) support for Targa files.
  1236.  
  1237.     VPIC ver 4.5a 08-15-91
  1238.         * Did some cosmetic fixes for mouse operation.
  1239.         * Marked files now don't stay marked when you change directories.
  1240.         * Added 2 pages of comment storage for GIF89a files.
  1241.  
  1242.                                                                         Page A8
  1243.  
  1244.  
  1245.  
  1246.     VPIC ver 4.6  08-23-91
  1247.         * Fixed a VESA related problem with late STB boards.
  1248.         * Added /v command line option to ignore VESA info and use config  file
  1249.           data.
  1250.         * Fixed a Windows BMP problem; removed compressed option for conversion.
  1251.         * Fixed GIF89a with comments problem.
  1252.  
  1253.     VPIC ver 4.7  never released
  1254.         Someone tried to add the Dark Avenger virus to VPIC in the Boston  area. You
  1255.         can't change a single byte in VPIC or it will refuse to  run,  since  it
  1256.         does a checksum on itself. They used a batch file or some  other  sneaky
  1257.         thing, and had the virus assemble and execute after exiting VPIC. It was
  1258.         not detected by Central Point Virus Scan, since it wasn't an EXE or  COM
  1259.         file, but was detected by someone there who sent me a  letter  with  the
  1260.         name and phone number of the person who uploaded it. The FBI is current-
  1261.         ly investigating it.
  1262.  
  1263.     VPIC ver 4.8  02-25-92
  1264.         * Fixed BMP viewing and conversion so Windows will read all files creat-
  1265.           ed by VPIC (compressed too), and VPIC will view all files that windows
  1266.           does. Change RLE extension to BMP for viewing compressed BMP's.
  1267.         * Added general means of telling VPIC in the  configuration  file  about
  1268.           the presence of the Sierra DAC and what modes it works in.
  1269.         * Updated CVPIC to work with new CFG files.
  1270.         * VPIC now comes up with mouse cursor out of  the  way  in  upper  right
  1271.           corner.
  1272.         * Added /l option for putting another picture on the screen from an app-
  1273.           lication; doesn't change the video mode.
  1274.         * Added Alt_D from menu to change the slide delay for marked files.
  1275.         * Added QUIT command in slide command file to do just 1 pass and quit.
  1276.         * Fixed numerous minor bugs in ver 4.6.
  1277.  
  1278.     VPIC ver 4.9   06-01-92
  1279.         * Fixed minor bug in /m command and updated help screen.
  1280.         * Fixed conversion to 16 color Windows BMP.
  1281.         * Fixed menu file marking bug where spacebar was ignored after  marking
  1282.           files with mouse.
  1283.         * Fixed bug in marked file viewing when saving or deleteing a file.
  1284.         * You can now lock the mode for marked file slide viewing.
  1285.         * Added Uncompressed DPII conversions.
  1286.         * Fixed a bug in VESA module for boards with dual VESA windows.
  1287.         * Updated CVPIC to handle VESA windows.
  1288.         * Added internal character table for boards which don't have characters
  1289.           built into Video BIOS (S3 in extended modes, 8514A, etc).
  1290.         * Fixed an annoying bug when you pressed ESC to end slide mode.
  1291.         * Fixed ATI viewing in mode 55h (1024x768x16).
  1292.